QuickTime 4 Reference

SMPTE Matrix Effects

kMatrixTransitionType ('smp4')

This effect is an implementation of the 34 matrix effects from ANSI/SMPTE 258M-1993, plus two Apple-defined wipes that choose a random effect. These are a series of matrix "reveal" type effects that take place between two sources. For full definitions of these 34 matrix effects and what they look like, please refer to the SMPTE documentation.

Example:

The SMPTE matrix effects take two sources and seven parameters.

Parameters

Use the descriptions below to help you understand what the parameters do. To learn how to use parameter atoms, see "Adding Video Effects to a QuickTime Movie"

Name	Code	QTAtom Type	Description
Percentage	`'pcnt'`	`kParameterTypeDataFixed` Always a tween	This parameter contains a tween. As the effect progresses, QuickTime renders the frame of the effect indicated by the tween's current value, as a percentage of the whole effect. For example, if the tween goes from 0 to 100, the effect renders completely; if the tween goes from 25 to 75, rendering begins 25% into the effect and terminates 75% through the effect.
Wipe ID	`'wpID'`	`kParameterTypeDataEnum`	Contains the SMPTE ID for the effect. By setting this parameter, you control which of the 34 available matrix effects is used. See the enumeration list below.
Soft border	`'soft'`	`kParameterTypeDataBitField`	If this parameter contains `true` , the border drawn around the second source is blurred.
Border width	`'widt'`	`kParameterTypeDataFixed` Can be a tween	The width, in pixels, of a border that is drawn around the second source.
Border color	`'bclr'`	`kParameterTypeDataRGBValue` Can be a tween	The RGB color of the border around the second source.
Horizontal repeat	`'hori'`	`kParameterTypeDataLong` Can be a tween	The number of horizontal repeats of the effect that are executed in a single source.
Vertical repeat	`'vert'`	`kParameterTypeDataLong` Can be a tween	The number of vertical repeats of the effect that are executed in a single source.

Wipe ID Enum

The Wipe ID parameter can take the following values:

Value	String
301	Horizontal matrix
302	Vertical matrix
303	Top left diagonal matrix
304	Top right diagonal matrix
305	Bottom right diagonal matrix
306	Bottom left diagonal matrix
310	Clockwise top left matrix
311	Clockwise top right matrix
312	Clockwise bottom right matrix
313	Clockwise bottom left matrix
314	Counter clockwise top left matrix
315	Counter clockwise top right matrix
316	Counter clockwise bottom right matrix
317	Counter clockwise bottom left matrix
320	Vertical start top matrix
321	Vertical start bottom matrix
322	Vertical start top opposite matrix
323	Vertical start bottom opposite matrix
324	Horizontal start left matrix
325	Horizontal start right matrix
326	Horizontal start left opposite matrix
327	Horizontal start right opposite matrix
328	Double diagonal top right matrix
329	Double diagonal bottom right matrix
340	Double spiral Top matrix
341	Double spiral bottom matrix
342	Double spiral left matrix
343	Double spiral right matrix
344	Quad spiral vertical matrix
345	Quad spiral horizontal matrix
350	Vertical waterfall left matrix
351	Vertical waterfall right matrix
352	Horizontal waterfall left matrix
353	Horizontal waterfall right matrix
409	Random effect (One of the 133 SMPTE effects is chosen at random)
504	Random matrix (One of the 34 SMPTE matrix effects is chosen at random)